home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / public / rayshade / README.sgi < prev    next >
Text File  |  1994-08-01  |  6KB  |  161 lines

  1.  
  2.           ~4Dgifts/toolbox/public/rayshade/Rayshade.4.0.6 README.sgi 
  3.  
  4.      
  5.      we are extremely pleased to include this ray tracing software package
  6.      with the express permission of Craig Kolb.  this software came from:
  7.      ftp:/princeton.edu/pub/Graphics/rayshade.4.0/rayshade.4.0.6.tar.Z
  8.      and the accompanying html documentation packages of Jelle van Zeijl's
  9.      RS_docs_html-1.4.tar.gz and Stephen Peter's raynotes.tar.gz from
  10.      ftp:/princeton.edu/pub/Graphics/rayshade.4.0/Contrib/Docs
  11.  
  12.      this file contains 3 sections:
  13.       *  COPYRIGHT NOTICE
  14.       *  DIFFERENCES WITH RAYSHADE 4.0.6
  15.       *  RUNNING Configure
  16.  
  17.  
  18.  _____________________________________________________________________________
  19.  _____________________________________________________________________________
  20. =================
  21. COPYRIGHT NOTICE:
  22. =================
  23.  
  24. The source, documentation, and examples in this Rayshade distribution are:
  25.  
  26. Copyright (C) 1989,1991,1992,1993, Craig Kolb
  27.  
  28. You may not distribute this software, in whole or in part, as part of
  29. any commercial product without the express consent of the authors.
  30.  
  31. Otherwise, this software may be freely copied, modified, and
  32. redistributed provided that this copyright notice is preserved on
  33. all copies.
  34.  
  35. There is no warranty or other guarantee of fitness of this software
  36. for any purpose.  It is provided solely "as is".
  37.  
  38.  
  39. For information on licensing Rayshade for use in your application,
  40. please contact:
  41.  
  42. Craig Kolb
  43. 39A Roxbury Court
  44. Princeton, NJ 08540
  45. (609) 924-9275 or
  46. (609) 258-1771
  47. cek@princeton.edu
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  _____________________________________________________________________________
  54.  _____________________________________________________________________________
  55. ===============================
  56. DIFFERENCES WITH RAYSHADE 4.0.6
  57. ===============================
  58.  
  59.     This version of rayshade 4.0.6 differs from the version distributed by
  60.     Craig Kolb, from Princeton, in one respect.  I made same quick 
  61.     alterations so that images are output in SGI RGB format using libimage 
  62.     instead of the rayshade standard which is Utah Raster format.  This 
  63.     change is significant in that you can no longer output images to 
  64.     standard out.  This means you can't do this with this version:
  65.  
  66.         rayshade example.ray > example.urt
  67.  
  68.     You have to specify an output file:
  69.  
  70.         rayshade example.ray -O example.rgb
  71.  
  72.     Also note that if you are producing a sequence of images for an 
  73.     animation at present the SGI RGB code will suffix the RGB file names 
  74.     with a frame number.
  75.  
  76.     My changes are in:
  77.  
  78.         libshade/picture.c
  79.  
  80.     Look for these changes marked by:
  81.  
  82.         #define SGI_RGB
  83.         #ifndef  SGI_RGB
  84.  
  85.     To disable these modifications remove:
  86.  
  87.         #undef URT
  88.  
  89.     and remove:
  90.  
  91.         #define SGI_RGB
  92.  
  93.     and  then recompile.
  94.  
  95.  
  96.     Also note that this rayshade distribution is the basic version of 4.0.6.
  97.     There are a number of patches available from various places to fix bugs
  98.     or add interesting new features to this version.  Time didn't permit
  99.     integrating and testing these so this is an exercise left to the reader.
  100.     Many of these mods are referenced in the HMTL docs.
  101.  
  102.     For the next DT I hope to improve my image file mods and put in more
  103.     patches.  I also plan to make some rayshade command files to produce
  104.     images of sphere's that can by using in Teschner and Henn's Phong
  105.     lighting eumlation using texture maps found elsewhere on Dave Ratcliffe's
  106.     way cool Developr's Toolbox.
  107.  
  108.     If you have questions or comments:
  109.  
  110.             millard@sgi.com
  111.  
  112.  
  113.  _____________________________________________________________________________
  114.  _____________________________________________________________________________
  115. ==================
  116. RUNNING Configure:
  117. ==================
  118.  
  119.      run Configure to set yerself up on the machine yer on.  press return
  120.      (i.e. go with the default) with every question except the following:
  121.  
  122. ...
  123. I see a config.sh file.  Did Configure make it on THIS system? [y] no
  124. Any additional libraries? [-lm -lmalloc -lc_s] -limage -lm
  125. ...
  126. Any additional cc flags? [ -DLANGUAGE_C] -cckr
  127. ...
  128. Function rand does not exists. Use that name anyway? [n] yes
  129. ...
  130. Run make depend now? [n] yes
  131.  
  132.  
  133.       the entire set of questions sequence you will be asked is listed below:
  134.      ------------------------------------------------------------------------
  135.  
  136. [Type carriage return to continue]
  137. [Type carriage return to continue]
  138. Any additional libraries? [-lm -lmalloc -lc_s] -limage -lm
  139. Which models are supported? [none]
  140. What command will force resolution on this system? [cc]
  141. What optimizer/debugger flag should be used? [-O]
  142. Any additional cc flags? [ -DLANGUAGE_C] -cckr
  143. Any additional ld flags (NOT including libraries)? [none]
  144. What directory holds the Utah Raster Toolkit include files? [none]
  145. Use which function to generate random numbers? [rand]
  146. Function rand does not exists. Use that name anyway? [n] yes
  147. How many bits does your rand() function produce? [15]
  148. Your void support flags add up to what? [11]
  149. Where do you want to put the public executables? (~name ok) [/usr/local/bin]
  150. Name of program to make makefile dependencies? [/usr/people/4Dgifts/toolbox/public/rayshade/Rayshade.4.0.6/mkdep]
  151. Which compiler compiler (yacc or bison -y) will you use? [yacc]
  152. End of configuration questions.
  153.  
  154.  
  155. Creating config.sh...
  156.  
  157. If you didn't make any mistakes, then just type a carriage return here.
  158. If you need to edit config.sh, do it as a shell escape here:
  159. ...
  160. Run make depend now? [n] yes
  161.